home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Multimedia / Resource Library: Multimedia.iso / archvrs / msdos / unsit23 / unsit.doc next >
Encoding:
Text File  |  1988-11-25  |  4.1 KB  |  102 lines
  1.  
  2.             UNSIT -- StuffIt Archive File Disassembler
  3.             ------------------------------------------
  4.  
  5. INTRODUCTION:
  6.      UNSIT  is a simple utility for PC users to extract files  from  a 
  7. StuffIt file.  StuffIt files usually appear with the ".SIT" extension.  
  8.  
  9.      StuffIt  is  a  program  for Macs similar to  ARC  for  PCs.   It 
  10. collects  several files in a single file and also compresses the  data 
  11. using run length, Huffman, or LZW compression.  StuffIt is emerging as 
  12. THE archive program for the Mac.   Unfortunately,  this means new  Mac 
  13. files   are   frequently   inaccessible to PC users as  they  are  now  
  14. "stuffed"  to  save transmission costs and disk space.  
  15.  
  16.      UNSIT  does not handle PackIt archive files which usually  appear 
  17. with the ".PIT" extension.  An extract-only utility called UnPackIt is 
  18. available on the PC.
  19.  
  20.  
  21. VERSION:
  22.      UNSIT Version 2.3
  23.  
  24.  
  25. PURPOSE:
  26.      List  files in and extract files from a StuffIt archive file on a 
  27. PC.  
  28.  
  29.  
  30. COMMAND OPTIONS:
  31.      unsit [l|v|x|e|xb|eb] StuffItFile[.SIT]
  32.  
  33.      l, v = list directory of files
  34.      x, e  = extract all files with CR to CR LF translation  on  text 
  35.                files
  36.      xb, eb = extract all files with no translation
  37.  
  38.  
  39.      Mac   files  come with two parts,   the resource fork  and   data 
  40. fork.   I  have not found any use on the PC for the resource fork  but 
  41. UNSIT will extract it anyway.
  42.  
  43.      The  normal  EXTRACT  options,  'x' or  'e',  will  automatically 
  44. convert Mac text files to PC text files.   The only difference appears 
  45. to  be Mac text file lines end with only a carriage return (CR)  while 
  46. PC text file lines end with carriage return (CR) and line feed (LF).  
  47.  
  48.      If  the translation causes any problems,  use the EXTRACT  BINARY 
  49. options, 'xb' or 'eb' to turn off the translation.  Non-text files are 
  50. always extracted without translation.  
  51.  
  52.  
  53. NOTICES:
  54.      Copyright  (c) 1988,  Brian K.  Uechi.   Portions of this program 
  55. written and copyrighted by Raymond Lau.   You may copy and  distribute 
  56. this  program  freely,  provided  that it is distributed ONLY  in  its 
  57. original, unmodified state.
  58.  
  59.      DISCLAIMER:   No warranty of any kind is made with regard to this 
  60. program.   The Authors shall be not liable for errors contained herein 
  61. or  for  incidental  or  consequential  damages  in  connection   with 
  62. furnishing, performance, or use of this material.
  63.  
  64. Brian K. Uechi
  65. GEnie:  B.UECHI
  66. CompuServe:  72330,155
  67.  
  68.  
  69. VERSION 2.3    23 Nov 1988
  70.      Earlier  versions always assumed the archive file started with  a 
  71. MacBinary header.   This is not always true.  UNSIT refused to process 
  72. these  files.   This version can handle zero or more MacBinary headers 
  73. on the archive file.  
  74.  
  75.  
  76. VERSION 2.2    27 May 1988
  77.      Older versions reversed LZW and Huffman compression types on the 
  78. file  directory  listing.   Decompression was always  done  correctly;  
  79. problem only affects report.
  80.  
  81.  
  82. VERSION 2.0    26 Feb 1988
  83.      UNSIT 2.0 now has an option to add a MacBinary header.   Some DOS 
  84. program  require this header for proper operation.   An extracted file 
  85. with  the MacBinary header should now exactly match the file  uploaded 
  86. directly  from a Mac.   A MacBinary header is added to Mac files  when 
  87. they are transmitted by almost all Mac terminal programs.   The header 
  88. contains  information from the Mac directory entry for that file  such 
  89. as file name, file type, and attribute flags.  
  90.  
  91.      A  Mac file with a MacBinary header contain a resource fork and a 
  92. data  fork,  either of which may be empty.   Some DOS programs do  not 
  93. work  correctly if the Mac file contains a non-empty resource fork  so 
  94. there  is an option to extract just the data fork even if  both  forks 
  95. are  present  in the SIT file.   It is also possible to  extract  both 
  96. forks into a single file.
  97.  
  98.      No new option flags have been added.  You will have the option to 
  99. put  a MacBinary header or not when extracting each file.   This makes 
  100. it  easier to extract a binary data file with a header then extract  a 
  101. text  file  without  a header in one pass through  the  Stuffit  file.  
  102.